SENDQ
Section: Protocol Families (4F)
Updated: September 22, 1993
Index
Return to Main Contents
NAME
sendq/q* -
FlexFAX
facsimile transmission job description
DESCRIPTION
Files in the
sendq
directory specify facsimile transmission job requests.
These files are usually created by
faxd.recv(1M),
when submitting a job on behalf of
sendfax(1).
Job description files are
ASCII
files with lines of the form
tag: value
where a tag is one of the identifiers described below
and a value is either a string or number.
If a line
begins
with the ``#'' character, it is ignored.
String values start at the first non-blank character
after the ``:'' and continue to the end of the line.
Numeric values are either decimal integers or floating point numbers.
The following table lists the possible tags and the required
type of the associated value.
Tag Type Description
dirnum integer directory offset of current page being sent
jobtag string user-specified job identifier
killtime integer time to give up trying to send facsimile
mailaddr string email address of sender
maxdials integer max number of times to dial
modem string outgoing modem to use
notify string email notification specification
npages integer number of pages transmitted
ntries integer number of attempts to send current page
ndials integer number of consecutive failed attempts to place call
number string dialstring to use in placing call
external string external form of dialstring
pagehandling string page analysis information
pagelength float facsimile page length (millimeters)
pagewidth integer facsimile page width (millimeters)
poll string polling request
postscript string postscript document specification
resolution float vertical resolution of facsimile
sender string identity of sender
sendjob string at(1) job identifier for delayed send job
status string job status
tiff string TIFF document specification
totdials integer total number of phone calls
tts integer time to send facsimile
PARAMETERS
- dirnum
-
The directory offset (starting at 0) of the current page
to be sent.
- external
-
The external form of the dialstring.
This string is used instead of the dialstring in any status
and log messages.
Clients can protect private information such as access codes
that must be placed in dialstrings by supplying a
``cleansed'' version of the dialstring.
- jobtag
-
A user-specified string that is intended for identification purposes.
If this string is defined, it is returned to the user in notification
messages.
- killtime
-
The time to kill this job, expressed in seconds
since 00:00:00 GMT, January 1, 1970.
- mailaddr
-
The electronic mail address to which notification
messages should be directed.
- maxdials
-
The maximum number of times the server should dial the phone.
If the job cannot be completed in this number of calls, it is terminated.
- modem
-
The outgoing modem to use to send the facsimile, or ``any''
if
any
modem can be used.
- notify
-
A specification of whether the sender wants
notification: whenever the job is requeued after
a failed attempt to transmit (``when requeued''),
when the job is completed (``when done''),
or not at all (``none'').
- npages
-
The number of pages in the facsimile, including
the cover page, that have been successfully transmitted.
- ntries
-
The number of unsucessful
attempts that have been made to transmit
the current page.
- ndials
-
The number of consecutive unsucessful
attempts to establish carrier with the
the destination facsimile machine.
- number
-
The dialstring to use to call the destination facsimile machine.
- pagehandling
-
A string used by the facsimile server during transmission.
The string has one character for each page to be transmitted.
``M'' indicates there is another page to follow and that the page
requires different T.30 session parameters be negotiated (an
EOM
code is to be transmitted).
``S'' indicates there is another page to follow, but the page
uses the same session parameters (an
MPS.
code is to be transmitted).
``P'' indicates this is the last page to be transmitted (an
EOP
code is to be transmitted).
- pagelength
-
The desired page length in millimeters.
- pagewidth
-
The desired page width in millimeters.
- poll
-
The value is a Caller Identification String (CIS)
to use in making a polling request.
- postscript
-
The value is a pathname to a file containing a
PostScripttm document to send.
Files must be owned by the
fax user.
Pathnames must be relative to the top of the
FlexFAX
spooling directory and not include ``..''.
- resolution
-
The desired vertical resolution in lines per inch.
This value should be either 98 or 196.
- sender
-
The ``full name'' of the sender of the facsimile.
- sendjob
-
The identifier returned by
at(1)
for the job that is to do a delayed submission
(if any).
- status
-
Status information about the current state of the job.
Typically this is the reason why the last attempt to
send the facsimile failed.
- tiff
-
The value is a pathname to a file containing a
TIFF
Class F document to send.
Files must be owned by the
fax user.
Pathnames must be relative to the top of the
FlexFAX
spooling directory and not include ``..''.
- totdials
-
The total number of times the server has dialed the phone.
- tts
-
The time to send the facsimile.
If this value is non-zero, it is number of seconds
since 00:00:00 GMT, January 1, 1970.
Otherwise, a value of 0 is interpreted to mean
transmit immediately.
SEE ALSO
sendfax(1),
faxd(1M),
faxd.recv(1M)
Index
- NAME
-
- DESCRIPTION
-
- PARAMETERS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 10:15:16 GMT, January 04, 2023